home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / sbrain.zip / SBRAIN.DOC < prev    next >
Text File  |  1993-01-08  |  20KB  |  493 lines
  1. 1/8/93
  2.                           THE BRAINEX SHOP MASTER
  3.                      A Credit Card Orders/Subcription Door
  4.                       (C) Copyright 1992 by Stanley Sheff
  5.                         Support BBS: The Brainex System
  6.                                (310) 275-2344
  7.                                (310) 273-5234
  8.  
  9.    > This door requires the Brainex Door Manager. If you have not done so, 
  10.    > please install The Door Manager BEFORE you attempt to setup this door.
  11.    > Be sure that your BRAINEX.DAT is dated on or after the date of
  12.    > SBRAIN.EXE.
  13.    
  14.    Welcome to the Shop Master.  This door allows your callers to upgrade
  15.    their subscriptions and levels or order products using a VISA, MASTER CARD,
  16.    AMERICAN EXPRESS, DINER'S CLUB, CARTE BLANCHE or DISCOVER CARD
  17.  
  18.    Shop Master creates it's own online product catalog, which may 
  19.    be downloaded or viewed online.
  20.    
  21.    * If you are a Teleflora Creditline user, Shop Master will work
  22.    * with TelePC to verify user's orders online, or after they log off
  23.    * the BBS. Amounts charged can be directly deposited into your
  24.    * checking account! For more information, read TELEPC.DOC.
  25.   
  26.    Shop Master will write an invoice file with all the information needed 
  27.    to process a credit card order.  Shop Master will check for a valid 
  28.    credit card number, but you will be required to verify the account 
  29.    by phone.
  30.  
  31.    GAP & PCBoard BBS: The door will automatically upgrade the user's 
  32.    level and subscription date online.
  33.  
  34.    PCBoard needs to write DOOR.SYS and USERS.SYS when running the door.
  35.    Shop Master updates DOOR.SYS for GAP or any DOOR.SYS type BBS. 
  36.    USERS.SYS is updated for PCBoard.
  37.    
  38.    
  39.    =====================================================================
  40.    If you have registered ORDER BRAIN before December 10, 1992, you can 
  41.    switch to The Shop Master at NO COST.  First, you will need to convert 
  42.    your ORDER.DAT file to CATALOG.DAT. Run the included CONVERT.EXE.  
  43.    Next, call the Brainex System, and post your BBS Name and Registration 
  44.    number in private mail to the SYSOP.  You will be issued a Shop Master 
  45.    registration number.  If you register ORDER after December 10, 1992,
  46.    you may apply your $25 Order Brain registration fee toward the purchase 
  47.    of The Shop Master. This makes the cost to switch only $20. 
  48.    =====================================================================
  49.    
  50.  
  51.     The Shop Master Files
  52.     ---------------------
  53.     SBRAIN.EXE   <------------------ The Shop Master Program
  54.     SBRAIN.DOC   <------------------ Sysop's Information
  55.     SBRAIN.HLP   <------------------ Online Door Help
  56.     CONVERT.EXE  <------------------ Converts ORDER.DAT to CATALOG.DAT
  57.     REGISTER.DOC <------------------ Registration information
  58.     PRODUCTS.DOC <------------------ Latest Brainex Products!
  59.     TELEPC.DOC   <------------------ CreditLine Information (Registered Version)
  60.     INVOICE.TXT  <------------------ Sysop's Invoice Template
  61.     RECEIPT.TXT  <------------------ Customer's Receipt Template
  62.     DEALS        <------------------ ASCII Special Deals
  63.     DEALSG       <------------------ ANSI Special Deals 
  64.     HAGGLE       <------------------ Haggle Data File
  65.     INFO         <------------------ ASCII General Help File
  66.     INFOG        <------------------ ANSI  General Help FIle
  67.     LEVEL        <------------------ ASCII Invalid Level Notice
  68.     LEVELG       <------------------ ANSI  Invalid Level Notice
  69.     MENU         <------------------ ASCII Order Options/Prices
  70.     MENUG        <------------------ ANSI  Order Options/Prices
  71.     NOTICE       <------------------ ASCII Warning Notice
  72.     NOTICEG      <------------------ ANSI Warning Notice
  73.     SUB          <------------------ ASCII Subscription Thank You File
  74.     SUBG         <------------------ ANSI Subscription Thank You File
  75.     THANKS       <------------------ ASCII Thank You (shown after an order)
  76.     THANKSG      <------------------ ANSI Thank You (shown after an order) 
  77.     FILE_ID.DIZ  <------------------ Short Door Description
  78.     SETUP.BAT    <------------------ Door Installer Batch File
  79.  
  80.  
  81.    NOTE-> If you have edited an ANSI info file and see a "MORE - Yes, No,..." 
  82.           prompt, you can either save the file with a longer line length (255)
  83.           or use a text editor to insert a { character on the first line 
  84.           of the file. This disables the "MORE - Yes, No,..." prompt when 
  85.           the file is shown by the door.
  86.        
  87.    All of these files should be in this ZIP, if they are not, don't
  88.    take a chance! Call The Brainex System and get a good copy or view the 
  89.    file on a few local boards to see if you can find a complete copy.
  90.  
  91.    To install, unzip these files into a work directory, then type:
  92.    
  93.    SETUP
  94.    
  95.    A BRAINEX\SBRAIN directory will be created.
  96.    
  97.    SBRAIN.EXE will be copied to the BRAINEX directory, the rest of the
  98.    files to the BRAINEX\SBRAIN directory.
  99.  
  100.    You will then be taken to the Door Manager Door Install area. 
  101.  
  102.  
  103. Shop Master Setup Questions/Options:
  104.  
  105. Please enter your Shop Master Registration number, or 0 if unregistered.
  106.    > When registered, Shop Master will save user's orderig information
  107.    > to an ascii file you specify. Unregistered version will not save
  108.    > to disk, but will otherwise function normally.
  109.  
  110. Please enter the DRIVE\DIRECTORY\NAME of the text to write information
  111. about orders placed by callers. (Do NOT include a file extension.)
  112.    > This is the name of the file that will hold all the information
  113.    > about a user's order. If the order was processed successfully,
  114.    > an extension of YES will be used, if the order did not pass
  115.    > the verification process, an extension of NO will be used. If
  116.    > you entered C:\CREDIT\ORDER as the file name, a good order would
  117.    > be stored as C:\CREDIT\ORDER.YES.
  118.  
  119. Enter the minimum caller access level required to use this door.
  120.    > Callers with an access level below this will not be able to
  121.    > access the door. They will be shown the LEVEL file.
  122.  
  123. Enter the level and above that will bypass this door?
  124.    > This level is usually used for the sysop who has setup Shop Master
  125.    > as a "logon" door, and does not wish to see the door during logon.
  126.  
  127. Enter the Credit Card types you will allow:
  128. VISA=VS, MASTERCARD=MC, AMERICAN EXPRRSS=AM, DISCOVER=DS
  129. DINER'S CLUB=DC, CARTE BLANCHE=CB, JCB=JB
  130.  
  131. When a user buys a BBS subscription, when should the
  132. user's additional subscription days begin?
  133. TODAY=New subscription period begins day of the order.
  134. EXPIRE=Add days after subscription expiration date.
  135.     > If a user buys a BBS subscription, the new time period can begin
  136.     > after the old on expires, or can begin on the day they order.
  137.     > Example: A user has 10 days left on a previous subscription, buys
  138.     > an additional 30 day subscription. If you set to TODAY, the user
  139.     > will have a total of 30 days remaining, if you set to expire,
  140.     > the user will have 30 new days added to the old 10, giving
  141.     > them a total of 40 days.
  142.     > Note: PCBoard adds additional days to the current expiration
  143.     > date, so this option will not matter.
  144.  
  145. Should Shop Master be allowed to lower a subscription level?
  146. YES=New user level can be lower than previous level
  147. NO=Only change if new level is above current level
  148.  
  149. Enter the colors for displayed text (B=Bright, BBLUE is Bright Blue)
  150. RED, GREEN, BROWN, BLUE, MAGENTA, CYAN, WHITE
  151. BBLACK, BRED, BGREEN, YELLOW, BBLUE, BMAGENTA, BCYAN, BWHITE 
  152.     > This is used for catlog text searches.
  153.  
  154. Enter the colors for search hit text (text found during searches)
  155. RED, GREEN, BROWN, BLUE, MAGENTA, CYAN, WHITE
  156. BBLACK, BRED, BGREEN, YELLOW, BBLUE, BMAGENTA, BCYAN, BWHITE 
  157.  
  158. Enter your Sales Tax Rate Percentage or NONE
  159.    > Example: 8.25
  160.  
  161. Enter your two letter State Abbreviation
  162.    > Use two letters only, do NOT add a period (CA.)
  163.    > Caller's from this state will be taxed.
  164.  
  165. Enter full State Name for tax
  166.    > Caller's from this state will be taxed.
  167.  
  168. Enter the DRIVE\DIRECTORY of Your TelePC software or }NONE
  169.    > This program will process your merchant account orders
  170.    > online without the need for a terminal! See the enclosed TELEPC.DOC 
  171.    > for information on how to obtain this software package!
  172.  
  173. Shop Master can process orders in one of two modes:
  174. ONLINE-Uses second comport/modem while caller is online.
  175.  
  176. * If you do not use TelePC, select ONLINE
  177.  
  178. OFFLINE-Processes the order after caller logs off the BBS.
  179. Select ONLINE or OFFLINE.
  180.  
  181. You may attach a TEXT FILE to user's receipts
  182. Please enter DRIVE\DIRECTORY\FILENAME.EXT or NONE.
  183.     > This should be an ASCII text file.
  184.  
  185. Enter your invoice start number. Invoices numbers will begin with this.
  186.     > Any Number
  187.  
  188. Enter the DRIVE\DIRECTORY where download files are located.
  189.     > If you want users to be able to download files using Shop Master,
  190.     > enter the directory location of the files. Enter NONE to disable 
  191.     > this option. 
  192.  
  193. Enter the DRIVE\DIRECTORY\FILENAME.EXT to your Files List (FILES.BBS)
  194.     > Complete path and filename of file description text file.
  195.     > This file uses a FILES.BBS type format. Each file should use the 
  196.     > following column format:
  197.  
  198. FILENAME            SIZE           DATE            DESCRIPTION
  199. 1<------------->13  14<------->21  24<-------->31  34<---------->78
  200.  
  201. Examples:
  202. ALADDIN.ZIP     89867  08/25/92  Aladdin's Magic Lamp Text Adventure
  203. SBRAIN.ZIP     123467  12/01/92  Shop Master - Credit Card Order Door
  204.  
  205. Would you like to allow callers to log off the BBS after downloads?
  206.     > YES or NO
  207.  
  208. Enter the Maximum Number of Minutes users may stay in the Shop Master.
  209.     > Any number from 1 to 32767
  210.  
  211. ---------------------------------------------------------------------
  212.    CATALOG.DAT file  
  213.    ================
  214.    Use an ASCII text editor to create your CATALOG.DAT file. This is
  215.    used by Shop Master to obtain specific information about the items
  216.    you will offer to your users.  
  217.  
  218.    CATALOG.DAT options:
  219.  
  220.    ITEM     - Brief Product Description
  221.    
  222.    INFOFILE - DRIVE\DIRECTORY\FILENAME.EXT of Descriptive Text File
  223.    
  224.    PRICE    - Price in Dollars and Cents format 00.00 (Don't use a $)
  225.    
  226.    TAX      - If the caller is not from out of state, tax will be
  227.               added if this option is TAX=YES
  228.    
  229.    SHIPPING - Shipping Fee in Dollars and Cents format 00.00 (Don't use a $)
  230.  
  231.    If using Shop Master for BBS subscriptions, you can use:
  232.  
  233.    LEVEL    - Upgraded user level. If the user's level is below this
  234.               level, the user will be upgraded to the indicated level.
  235.    
  236.    DAYS     - Addtional Days added to user subscription period
  237.  
  238.    End each item section with three dashes ---
  239.  
  240.    Sample CATALOG.DAT file format:
  241.    
  242.    ITEM=One Month BBS Subscription
  243.    INFOFILE=C:\BRAINEX\SBRAIN\INFO.TXT
  244.    PRICE=15.00
  245.    LEVEL=90
  246.    DAYS=30
  247.    ---
  248.  
  249.    ITEM=Night Owl CD-ROM Volume 7
  250.    INFOFILE=C:\BRAINEX\SBRAIN\CDROM.TXT
  251.    PRICE=30.00
  252.    TAX=YES
  253.    SHIPPING=2.00
  254.    ---
  255.  
  256.    ITEM=Printed BBS Manual
  257.    PRICE=2.00
  258.    ---
  259.  
  260.    You must include an item and a price. Other selections are optional.
  261.  
  262.  
  263.    INVOICE.TXT (Sysops Invoice Record) 
  264.    RECEIPT.TXT (Customer's Receipt)
  265.    =========================
  266.    These are text file templates that use special replacable commands:  
  267.    
  268.    @INVOICE                                    @CARDINFO
  269.    @DATE                                       @ADDRESS
  270.    @TIME                                       @HOMEPHONE
  271.    @VERIFICATION                               @BBSNAME
  272.    @USERNAME                                   @BBSPHONE
  273.    @TAX                                        @SHIP
  274.    @TOTAL                                      @DISC
  275.    
  276.    After an order, Shop Master replaces these "@" commands with the 
  277.    actual user information, then writes a file to disk as the FILENAME 
  278.    you specified above (order information file). 
  279.    
  280.    RECEIPT.TXT may be read or downloaded by the user. Be sure to edit
  281.    in your BBS information!
  282.    
  283.    Please EDIT these file as you wish using any ascii text editor. 
  284.    Be sure your editor does not use CONTROL Z to terminate a line.  
  285.    The replacable parameters should be the LAST ITEM on a line 
  286.    (@DATE, @TIME, etc.). These files should be located in BRAINEX\SBRAIN.
  287.  
  288.  
  289.    DEALS.TXT
  290.    =========
  291.    If you wish to offer any special deals, create this file and place
  292.    it in your BRAINEX\SBRAIN directory. Optional ANSI version should
  293.    be named DEALSG.TXT
  294.  
  295.    HAGGLE   
  296.    ======
  297.    If present in the BRAINEX\SBRAIN directory, Shop Master will allow 
  298.    you to offer a discount. Users can select the [H]aggle option before
  299.    they place an order, and try to haggle a better price! You can select
  300.    the name of the "haggler", the maximum discount percentage rate offered, 
  301.    and the a choice of remarks made by the haggler to the user.
  302.  
  303.    Sample HAGGLE file:
  304.    ------------------------------------------------
  305.    MAXIMUM HAGGLE DISCOUNT=10
  306.    HAGGLER NAME=Crazy Murray
  307.    You think I'm made of money?
  308.    You'll have to do better than that, my friend!
  309.    That's not an offer, that's a joke!
  310.    Let's get real, ok?
  311.    Talk to me when you get serious...
  312.    I might be crazy, but I'm not THAT crazy!
  313.    Talk some turkey!
  314.    Hmmm... That's an interesting offer, but no deal!
  315.    -------------------------------------------------
  316.    The maximum haggle discount is a percentage, so the above example
  317.    would allow a maximum discount of 10% off the total purchase price.
  318.    The discount will be indicated in receipts and invoices with the @DISC
  319.    parameter.
  320.  
  321.    You may add as many haggle remarks as you like, just put each on
  322.    a seperate line as shown above.
  323.    
  324.    Remove the HAGGLE file from the BRAINEX\SBRAIN directory to 
  325.    disable haggling.
  326.  
  327.  
  328.    CATALOG
  329.    =======
  330.    The first time you run Shop Master, it will create two catalog files
  331.    in the BRAINEX\SBRAIN directory.
  332.    
  333.    CATALOG.STD - (Standard Catalog) Item, Price, Shipping 
  334.    
  335.    CATALOG.DLX - (Deluxe Catalog) Item, Price, Shipping, 
  336.                  Detailed Item Information
  337.                  (Derived from the text you supplied in INFOFILE=files)
  338.    
  339.    Users may View, Search, Order from the Catalog, or Download the catalog.  
  340.    
  341.    DOWNLOADS REQUIRE DSZ or GSZ
  342.    ============================
  343.    Place DSZ.COM or DSZ.EXE in the path. If you have an unregistered DSZ, 
  344.    Y-Modem G protocol will NOT function.  If you wish to use GSZ,
  345.    simply rename GSZ.EXE to DSZ.EXE, or you can edit the batch files
  346.    that call GSZ. They are located in the BRAINEX directory, and
  347.    are named: EXTSZ.BAT, EXTS1.BAT, etc.  You should add an environment
  348.    variable to set the dsz log file name, and if using gsz, the window
  349.    size. If the DSZLOG varible is not set, NO download logs will be
  350.    written.  See the sample batch files below.
  351.  
  352.    
  353.    RUNNING SHOP MASTER
  354.    ===================
  355.    
  356.    Once you have created your CATALOG.DAT, you must then create a a batch 
  357.    file to call the door. A batch file for a GAP BBS might look like this:
  358.    
  359.      @ECHO OFF
  360.      SET GSZWINDOW=23
  361.      SET DSZLOG=LOG1
  362.      SBRAIN
  363.      
  364.    Multinode BBSes use the NODE= command. Example:
  365.  
  366.    @ECHO OFF
  367.    SET GSZWINDOW=23
  368.    SET DSZLOG=LOG2
  369.    SBRAIN NODE=2
  370.  
  371.    ========================================================================
  372.    TELEPC (Registered Version Only)
  373.    
  374.    Telepc-b.exe must be configured and working correctly. 
  375.    There are two modes of operation.
  376.  
  377.    1. Online Mode. Using a second comport and modem, Shop Master
  378.    will shell to Telepc-b.exe and process the order while the caller
  379.    waits. 
  380.  
  381.    2. Offline Mode. Shop Master will shell to Telepc-b.exe when the
  382.    user logs off the BBS.  To use the offline function, run Order
  383.    Brain with the offline option.
  384.  
  385.    SBRAIN NODE=2 OFFLINE
  386.    or
  387.    SBRAIN OFFLINE
  388.    etc.
  389.  
  390.    If you use Shop Master in OFFLINE MODE with the Telepc Program,
  391.    you will need to modify the batch file that runs your BBS:
  392.  
  393.    Sample GAP BBS Batch file (GAP.BAT) :
  394.    
  395.    @ECHO OFF
  396.    GAPMENU
  397.    IF ERRORLEVEL 99 GOTO SHOP
  398.    GOTO END
  399.    :SHOP
  400.    SBRAIN OFFLINE
  401.    GAP
  402.    :END
  403.  
  404.    Sample PCBoard Batch File (BOARD.BAT) :
  405.  
  406.    @ECHO OFF
  407.    C:
  408.    CD \PCB
  409.    SET PCB=/SWAP
  410.    SET DSZLOG=C:\PCB\PCBDSZ.LOG
  411.    IF EXIST REMOTE.BAT RENAME REMOTE.BAT REMOTE.SYS
  412.    IF EXIST EVENT.BAT RENAME EVENT.BAT EVENT.SYS
  413.    IF EXIST DOOR.BAT DEL DOOR.BAT
  414.    IF EXIST ENDPCB DEL ENDPCB
  415.    PCB145
  416.    IF EXIST REMOTE.BAT REMOTE
  417.    IF EXIST DOOR.BAT DOOR
  418.    IF EXIST EVENT.BAT EVENT
  419.    IF EXIST ENDPCB GOTO END
  420.    SBRAIN OFFLINE
  421.    BOARD
  422.    :END
  423.    EXIT
  424.    
  425.    The above modifications are only required when using The Shopping Door
  426.    in OFFLINE mode.
  427.    =======================================================================
  428.  
  429.    
  430.    The following sysop functions are available while awaiting
  431.    keyboard input :
  432.  
  433.      F5      - Shell to DOS.
  434.      F8      - Twit user and return to BBS.
  435.     F10      - Initiate chat with user.
  436.     CF10     - Answer user page bell.
  437.     Home     - Main user stats.
  438.     End      - Displays sysop keys available.
  439.     PgDn     - Secondary user stats.
  440.     Up Arrow - Increase user's time remaining by 5 minutes.
  441.     Dn Arrow - Decrease user's time remaining by 5 minutes.
  442.  
  443.    One of the nicer features about using the TWIT key, is the user
  444.    is not told that "the sysop wants them to return to the BBS".
  445.    Instead, a very plain and simple message of "returning you to the
  446.    BBS" is displayed.  This way, the user is given no indication
  447.    that the sysop is hovering about.
  448.  
  449.    When using the F5 shell to DOS key, to return to the door
  450.    program, simply type EXIT at the DOS command prompt. It is not
  451.    necessary to change directories back to the door directory.
  452.    The Shop Master is smart enough to know which drive and directory the
  453.    door program is in and will reset the defaults upon return from
  454.    DOS.
  455.  
  456.    The Up and Down Arrow keys increase and decrease the user's time
  457.    respectively by 5 minutes for each press of the key. There is no
  458.    indication of what is occurring (except by the fact the user's
  459.    time remaining will change), so the sysop should try not to have
  460.    a lead finger. The increase or decrease is effective only while
  461.    the user is in The Shop Master.
  462.  
  463.                                --  --  --
  464.  
  465.    
  466.    This version of The Shop Master is a DEMO. 
  467.    
  468.    No orders will be processed or written to file.
  469.  
  470.    It will become full featured upon registration. This door is released 
  471.    "As Is" and there is *NO* warranty or guarantee that it will work for 
  472.    you and not cause any problems. You have chosen to use this door, YOU 
  473.    are responsible for any unfortunate problems that may develop from its 
  474.    use or misuse. I will gladly listen to any suggestions or problems you 
  475.    may have, and I will do my best to fix whatever needs to be fixed. 
  476.    I can not be held responsible for any problems you may have, whether 
  477.    directly or indirectly due to the use of the door.
  478.    
  479.    Please read REGISTER.DOC for information on how you can register
  480.    your copy of The Shop Master. 
  481.  
  482.    For complete support, contact me on The Brainex System.
  483.    Your questions will be quickly and cheerfully answered!
  484.  
  485.  
  486.    Have Fun!
  487.    Stanley Sheff
  488.    The Brainex System
  489.    310-275-2344 HST
  490.    310-273-5234 V.32bis
  491.  
  492.    Voice Support for Registered Sysops!
  493.